home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d19 / zlabp_11.arc / ZIPLAB.DOC < prev   
Text File  |  1991-10-29  |  18KB  |  535 lines
  1.  
  2. ZipLab PLUS Version 1.0
  3. (C)Copyright 1991 by Jeffrey S. Morley
  4. October 15th, 1991
  5.  
  6. Archive test program for PCBoard/ProDoor
  7.                   
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58. Page 1                                                         ZipLab Plus 1.0
  59.  
  60.  
  61.  
  62.  
  63.                                Table of Contents
  64. ===============================================================================
  65.  
  66. Configuration Changes (PTEST.CFG) / Quick Start ...........................  3
  67. PTEST.CFG Changes and Description / Example ...............................  4
  68. ProDoor Setup .............................................................  6
  69. ZipLab Plus Features and Changes ..........................................  7
  70. Credits ...................................................................  8
  71.  
  72.  
  73.  
  74. What is ZipLab Plus?
  75.  
  76.    ZipLab is an alternative/replacement for the PCBTEST.BAT/PROUTEST.BAT 
  77. files which are run by PCBoard/PRODOOR after a user uploads file(s). In 
  78. the past, we have all run maybe  PKUNZIP -T  on each file, and if there 
  79. were no CRC errors, all was considered well.   There is a lot more we can 
  80. do  to protect ourselves and our users from unwanted files!  ZipLab will 
  81. do the following:
  82.  
  83. * Test for CRC errors in the archive file.
  84. * Test for imbedded archive files and if found, CRC check those too.
  85. * Test for imbedded .TD0 (Teledisk) files and if found, test with TDCHECK.
  86. * Virus SCAN archive member files, using SCAN.EXE from McAffey.
  87. * SCAN inside archive files imbedded inside another archive file.
  88. * Remove all archive comments from the file.
  89. * Replace archive comments with your own. (Optional)
  90. * Delete unwanted BBS ads and/or other unwanted archive members as you define.
  91. * Test .GIF files for validity if you accept that file format (Optional)
  92. * Reject programs older than a date (year) which you specify.
  93. * Adds most recent archive member date to the description (Optional)
  94. * Allow you to test outside of PCBoard/ProDoor, and use wildcards!
  95. * Run the full range of tests on .ZIP, .LHZ and .ARJ archive formats
  96. * Run SCAN files which you optionally pass without ZIP testing.
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  SPECIAL NOTICE ***** SPECIAL NOTICE **** SPECIAL NOTICE ***** SPECIAL NOTICE
  103.  
  104.  
  105.  
  106.   ** ZIPLAB IS NO LONGER "FREEWARE". REGISTRATION IS REQUIRED FOR ITS USE **
  107.  
  108.     PLEASE SEE THE ENCLOSED REGISTER.DOC FILE FOR REGISTRATION INFORMATION
  109.  
  110.  
  111.           
  112.  SPECIAL NOTICE ***** SPECIAL NOTICE **** SPECIAL NOTICE ***** SPECIAL NOTICE
  113.  
  114.  
  115.  
  116.  
  117.  
  118. Page 2                                                         ZipLab Plus 1.0
  119.  
  120.  
  121.  
  122. ********* A CHANGE TO YOUR .CFG FILE *IS* REQUIRED FOR THIS RELEASE! *********
  123.  
  124. REQUIRED FOR OPERATION:
  125.  
  126. You must already have the following programs.....
  127.  
  128. PKZIP.EXE   - Phil Katz archive create program (version 1.01 +)
  129. PKUNZIP.EXE - Phil Katz archive extract program (version 1.01 +)
  130. LHARC.EXE   - Yoshi's archive program (version 2.12 +)
  131. ARJ.EXE     - Robert Jung's archive program (version 2.10 +)
  132. TDCHECK.EXE - .TD0 (Teledisk) checker from SyDex (any version)
  133. SCAN.EXE    - McAffey's virus detection program (any version)
  134.  
  135. There are other small utility programs which I have bundled with this 
  136. .ZIP. They may require registration for continued use.  PLEASE SUPPORT 
  137. SHAREWARE AND THE SHAREWARE CONCEPT! REGISTER THESE PROGRAMS IF REQUESTED 
  138. TO DO SO!
  139.  
  140. RECOM.EXE   - Mike Loewen's ZIP file comment remover and date stamper.
  141. GIFTEST.EXE - Dave Navarro's .GIF file tester (part of GIFTSTxx.ZIP)
  142. DELF.COM    - A version of DEL with no "Are you sure?" prompt written by me.
  143.               (No registration required)
  144.  
  145.  
  146. Quick Start ---
  147.  
  148. * NOTE!  Since PCBoard is SHELLING out to run PCBTEST.BAT, there is 
  149.   limited memory available for PTEST.EXE.  If you are running in a 
  150.   multitasking or other memory constrained situation, PTEST may not work! 
  151.   You should have at least 210k free memory when shelled out of PCBoard.  
  152.   If this is a problem, you may want to consider the VAROOM (overlay) 
  153.   version of PCBoard, which runs in considerably less memory than the 
  154.   standard PCB.EXE.
  155.   
  156.   The other option is to run PCBoard with the SET PCB = /SWAP environment 
  157.   variable.  This will cause PCBoard to "swap" its code to the best 
  158.   available storage (EMS, DISK) whenever a SHELL function (external 
  159.   protocol, viewfile, and even DOORS if you have the SHELL column in 
  160.   DOORS.DAT(LST) set to "Y") is called.  This method will cause a slight 
  161.   delay when SHELLING, but will provide the largest amount of available 
  162.   DOS memory for your external code.
  163.   
  164. * Place the PTEST.EXE, SETUP.EXE and DELF.COM files into a directory which 
  165.   is in your DOS PATH.
  166.  
  167. * UnZIP the enclosed supplemental utilities into directories in your DOS 
  168.   PATH. Make note of where you put them, you will need this information 
  169.   later.
  170.  
  171. * Create, or use any existing directory to hold your PTEST configuration 
  172.   files. Change into this directory, and run SETUP.EXE once for each of 
  173.   your nodes. Be sure to give different configuration file names for each 
  174.   node.  I use PTEST1.CFG and PTEST2.CFG. You may keep the particular 
  175.   node's configuration file in the PCBoard ROOT/HOME directory for the 
  176.   node, but this is not required.  
  177.  
  178.  
  179.  
  180. Page 3                                                         ZipLab Plus 1.0
  181.  
  182.  
  183. * Fill in the following information when prompted by SETUP.EXE:
  184.  
  185.         -  The [drive:\path\]filename.ext of the .CFG file you wish created.
  186.            (This information will not be written to the .CFG file)
  187.         -  The type of modem HANDSHAKE you desire.  This can be 
  188.            0, 1, 2 or 3.  0=none, 1=XON/XOFF, 2=CTS, 3=CTS & XON/XOFF
  189.            (Use 2 or 3 with an error correcting modem...)
  190.         -  The DRIVE:\PATH\NAME of your PCBOARD.DAT file for this node.
  191.         -  The name of your BBS system.  43 characters maximum.
  192.         -  The DRIVE and PATH to the directory where rejects will be
  193.            placed pending manual sysop inspection.
  194.         -  The date (yyyy) which will be the minimum accepted year.  ZIPs
  195.            containing files older than this will be rejected.
  196.         -  A "Y" if you wish the "recent date" notation added to the file
  197.            descriptions.  A "N" if you do not wish this addition.
  198.         -  The fully qualified filename of the zip comment to add, or
  199.            type "NONE" if you don't want to add a comment.
  200.         -  The fully qualified filename of a file which you may wish to
  201.            add to the .ZIP, or "NONE" (please!) if you can refrain from
  202.            this practice.
  203.         -  Full DRIVE:\PATH to PKZIP.EXE.
  204.         -  Full DRIVE:\PATH to PKUNZIP.EXE.
  205.         -  Full DRIVE:\PATH to LHARC.EXE.
  206.         -  Full DRIVE:\PATH to ARJ.EXE.
  207.         -  Full DRIVE:\PATH to TDCHECK.EXE.
  208.         -  Full DRIVE:\PATH to SCAN.EXE.
  209.         -  Full DRIVE:\PATH to RECOM.EXE.
  210.         -  Full DRIVE:\PATH to GIFTEST.EXE (or NONE if not using)   
  211.            NOTE!!! This was TESTGIF.EXE in previous versions, but is now
  212.            the more powerful GIFTEST.EXE from the same author.
  213.         -  The DRIVE:\PATH\FILENAME of your GIFTEST.CFG file.
  214.            Just enter NONE if you do not desire to test .GIF files.  
  215.         -  A list, each on one line, of any extensions (.EXE, .TXT 
  216.            etc) Which will be passed without normal ZIP testing.  SCAN 
  217.            will still be performed on these files.  Any extensions 
  218.            other than .ZIP which do not appear in this .CFG file will 
  219.            be rejected by the process.  The "." is optional. If .GIF 
  220.            appears in this list, GIFTEST will be used to test the 
  221.            integrity of the .GIF file.
  222. NEW!!      If you enter a "*" as one of the extentions, then ALL files 
  223.            will be passed through, with non-archived files being 
  224.            SCAN'd only.
  225.         -  A list, each on one line, of files which you wish deleted 
  226.            from .ZIP's before posting.  This could include the famous 
  227.            "READMEOR.DIE", "BBS.AD", or other unwanted advertising. 
  228.            You may also have a file with these names listed one on 
  229.            each line, and pass the name of the file with an "@" before 
  230.            the name.
  231.  
  232.  
  233.  
  234.  
  235.  
  236.  
  237.  
  238.  
  239.  
  240.  
  241.  
  242.  
  243.  
  244.  
  245.  
  246. Page 4                                                         ZipLab Plus 1.0
  247.  
  248.  
  249. Sample PTEST.CFG file:
  250.             
  251.             2           
  252.             C:\NODE1\PCBOARD.DAT
  253.             The Interconnect BBS
  254.             M:\HOLD
  255.             1990
  256.             Y
  257.             C:\EXE\COMMENT.CMT
  258. NEW!!       C:\EXE\FILETO.ADD
  259.             C:\ZIP\PKZIP.EXE
  260.             C:\ZIP\PKUNZIP.EXE
  261. NEW!!       C:\ZIP\LHARC.EXE
  262. NEW!!       C:\ZIP\ARJ.EXE
  263.             C:\ZIP\TDCHECK.EXE
  264.             C:\DIAGS\SCAN.EXE
  265.             C:\EXE\RECOM.EXE
  266. NEW!!       C:\EXE\GIFTEST.EXE
  267. NEW!!       C:\EXE\GIFTEST.CFG
  268.             .ROM
  269.             .GIF
  270. NEW!!       @BBSADS.LST
  271.  
  272. * Edit your existing PCBTEST.BAT file, and delete the whole thing except 
  273.   for two lines:
  274.   
  275.   Sample PCBTEST.BAT file:
  276.   
  277.   @ECHO OFF
  278.   PTEST %1 C:\ZIPLAB\PTEST1.CFG
  279.  
  280.    
  281. * That's it... Now when PCBTEST.BAT is run by PCBoard, it will pass 
  282.   command over to PTEST.EXE with the parameter containing the path
  283.   and name of the file to be tested.  PTEST will check out the file,
  284.   placing any rejects in the holding directory you specified in the
  285.   SETUP process above.  
  286.  
  287.   
  288.  
  289.  
  290.  
  291.  
  292.  
  293.  
  294.  
  295.  
  296.  
  297.  
  298.  
  299.  
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306. Page 5                                                         ZipLab Plus 1.0
  307.  
  308.  
  309.  
  310. *  PRODOOR SYSOPS -
  311.    You will need to set up your PROUTEST.BAT file like this:
  312.                 
  313.    echo off
  314.    rem -- process test uploads request - for ProDOOR 3.4
  315.    rem -- %1-logfile, %2-testdir, %3-comport
  316.    
  317.    rem -- test each uploaded file individually
  318.    proecho %3 ~~Testing uploads.  Please wait...~
  319.    
  320.    SET PCBDOOR=PRODOOR
  321.    for %%f in (%2\*.*) do COMMAND /c PTEST %%f drive:\directory\configfilename
  322.    SET PCBDOOR=
  323.    
  324.    :end
  325.             Replace the "drive:\..." stuff with the location and name
  326.             of the PTEST configuration file for this node.
  327.  
  328.              Be sure you have enough ENVIRONMENT space to set up the
  329.              PCBDOOR variable.  If you are using DesqView, you may
  330.              want to set PCBDOOR=xxxxxxx in your AUTOEXEC.BAT to be
  331.              sure enough room is allocated in your DesqView partitions
  332.              for this variable.  The x's will be replaced by PRODOOR
  333.              when PROUTEST.BAT is executed.  I need this variable set
  334.              to "PRODOOR", or PTEST won't know you are running out of
  335.              ProDoor.  You don't want to leave it set to PRODOOR though,
  336.              since this could confuse things for other doors/processes.
  337.              Thus the "SET PCBDOOR=" line.  ZipLab will fully work
  338.              with ProDoor, including display/modification of the file
  339.              descriptions.
  340.   
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365. Page 6                                                         ZipLab Plus 1.0
  366.  
  367.  
  368.  
  369. NEW!! IN THIS VERSION *********************************************************
  370.  
  371.                             ZipLab PLUS Version 1.1
  372.                             
  373. * I had left in a lot of "local" display of the testing process, so that I
  374.   could get useful debugging information back from my users.  I have now
  375.   removed as much as possible of the local displays, and the process should
  376.   look a lot less jerky to the watching sysop.
  377.   
  378. * Added a the ability to use ".*" as one of the extensions which will be
  379.   passed without archive testing.  If you put ".*" in using Setup.Exe, ALL
  380.   files will be passed.  Files passed with this method OR by specifing
  381.   particular extensions in PTest.Cfg will still be SCAN'd for virus'.  
  382.   
  383. * Fixed a problem where in LOCAL mode using wildcards, a directory which
  384.   contained a mixture of archive types (ZIP, ARJ, LZH) would cause problems
  385.   after testing the first type.
  386.   
  387. * Some users were having problems reassigning the "working" directory.  This
  388.   is by default PTEST.DIR under the current directory (C:\PCB\PTEST.DIR\ for
  389.   most sysops), but can be changed to another directory with an environment
  390.   variable.   In your Autoexec.Bat, the line "SET ZIPLAB=d:\path" will allow
  391.   any drive and directory to be used for the "working" directory.  PLEASE,
  392.   remember that this directory will be used and DELETED when the process is
  393.   done.  Several people tried to use C:\PCB or just C:\ and experienced 
  394.   unfortunate effects.  I have tested ZipLab PLUS with a ramdrive as the
  395.   "working" directory, and it seems to work fine.  There may be a problem
  396.   with directories containing a "." in early versions of DOS. if you are
  397.   not running DOS 4.0 or later, and are having problems with ZipLab Plus,
  398.   you may want to try reassigning to another directory name.
  399.   
  400. * Descriptions will not be modified if you are not running PCBoard 14.5(a)
  401.   or later.  Early 14.5 versions didn't save the descriptions in the same
  402.   location during the testing process, and ZipLab Plus won't find them.
  403.                             
  404.                             
  405.                             ZipLab PLUS Version 1.0
  406.                 
  407. * This is the new ZipLab PLUS!  A lot of hard work has gone into this and 
  408.   earlier versions,  and I will be requiring a *REGISTRATION FEE* with 
  409.   this version.  See REGISTER.DOC for details on how to register ZipLab 
  410.   PLUS.
  411.                 
  412. * ZipLab will now test .ARJ and .LZH files, as well as the .ZIP format.  
  413.   You will need to have ARJ.EXE and LHARC.EXE if you accept these formats, 
  414.   and a change to the .CFG file is *REQUIRED* to tell PTEST where they 
  415.   are.  You must put them in the PTEST.CFG file, even if you don't accept 
  416.   these formats,  and don't have the programs... Just lie to it.
  417.                 
  418. * ZipLab now fully supports ProDoor as well as PCBoard.
  419.  
  420. * You may now run ZipLab while out of the bulletin board system and use 
  421.   wildcards (* or ?) in the testing procedure. This will allow you to test 
  422.   existing archive file(s) on your system.  *NO* changes will be made to 
  423.   existing descriptions. To enable this feature, place the word LOCAL at 
  424.   the end of the PTEST command line.
  425.  
  426.   EXAMPLE: C:\ZIPLAB>PTEST m:\pcb\dir1\*.zip ptest.cfg LOCAL
  427.                 
  428. * ZipLab will now SCAN archives inside archives to test for virus 
  429.   infestation.
  430.                 
  431. * You may now have rejected uploads left in your private directory if you 
  432.   prefer this setup.  Set the "holding" directory  to the location of your 
  433.   "private" or "upload"  directory  (whichever you wish),  and the file(s) 
  434.   will remain there. The description(s) will be posted to your "private" 
  435.   dir file.  This corrects a situation where sysops trying to do this with 
  436.   earlier releases of ZipLab would lose the rejected file.
  437.                 
  438. * By default, ZipLab will use a directory called PTEST.DIR under the 
  439.   current directory for unzip'ing and testing purposes.  This directory 
  440.   will be erased and removed by ZipLab at the end of the run.  If you wish 
  441.   to use another directory for this purpose (like a RAM drive to improve 
  442.   speed), set the DOS environment variable "ZIPLAB".  
  443.  
  444.   EXAMPLE:  SET ZIPLAB=E:\WORKDIR
  445.  
  446. * You may choose to add a file to the archive package, by adding the 
  447.   appropriate information to the PTEST.CFG file.  I am opposed to this 
  448.   practice, but don't desire to tell anyone how to run their shop.
  449.  
  450. * The ORIGINAL file date of the archive file is now retained. Earlier 
  451.   versions of ZipLab would set the archive file date  to the date of the 
  452.   newest member in the archive.  This was required for age testing, but is 
  453.   no longer.
  454.                 
  455. * ZipLab will NOT leave behind  "hidden,  read-only  or  system" files 
  456.   which were imbedded in archives.  They will be tested, and properly 
  457.   deleted when the tests are finished.
  458.                 
  459. * ZipLab now uses GIFTEST.EXE to test .GIF files (if permitted).  This 
  460.   program by Dave Navarro will allow you to set up a GIFTEST.CFG file - 
  461.   giving you even more control over  .GIF  testing.  An addition to your 
  462.   PTEST.CFG file is required to support this.  Please read the docs with  
  463.   GIFTSTxx.ZIP  for details  on  how to best set up the GIFTEST.CFG file. 
  464.   YOU MUST REGISTER GIFTEST TO USE IT!
  465.                 
  466. * You may now put all BBS advertising file  names  into a text  file, one 
  467.   on each line.  In PTEST.CFG, place an "@" before the name of this text 
  468.   file, and ZipLab will delete all listed advertising  files in one pass.  
  469.   THIS IS MUCH FASTER for those with multiple advertising files to reject.
  470.  
  471.  
  472.  
  473.  
  474. Page 7                                                         ZipLab Plus 1.0
  475.  
  476.  
  477.  
  478. ***********************************************************************************************
  479.  
  480.    This program was written in QuickBasic 4.5, with some help from 
  481. Hammerly Computing's ProBas 4.01.   I have also included a few utilities 
  482. which PTEST will use in the course of testing.  These utilities are the 
  483. property of the authors, and you are strongly requested to register them 
  484. if you continue to use ZIPLAB PLUS.
  485.  
  486.                              Jeffrey S. Morley
  487.                            The Interconnect BBS
  488.                                (703)425-2505
  489.  
  490.             PLEASE SEE REGISTER.DOC FOR REGISTRATION INFORMATION
  491.  
  492.                 (C)Copyright 1989-1991 by Jeffrey S. Morley
  493.  
  494.  
  495.  
  496.  
  497.  
  498.  
  499.  
  500.  
  501.  
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532.  
  533. Page 8                                                         ZipLab Plus 1.0
  534.  
  535.